package com.zs.blog.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.zs.blog.constant.enums.ResponseResultEnum;
import com.zs.blog.model.dto.UserLoginDTO;
import com.zs.blog.model.dto.UserSearchDTO;
import com.zs.blog.model.dto.UserUpdateTypeDTO;
import com.zs.blog.model.entity.User;
import com.zs.blog.model.vo.PageInfoVO;
import com.zs.blog.model.vo.UserDetailVO;
import com.zs.blog.model.vo.UserListVO;

import java.util.List;

/**
 * @Title: IUserService
 * @Author zs
 * @Package com.zs.blog.service
 * @Date 2025/4/14 23:30
 * @description: 用户服务层接口
 */
public interface IUserService extends IService<User> {
    /**
     * 用户登录
     *
     * @param username 用户名
     * @param password 密码
     */
    UserLoginDTO login(String username, String password);

    /**
     * 用户注册
     *
     * @param user 用户实体类
     */
    void register(User user);

    /**
     * 获取分页的用户信息列表
     *
     * @param pageNum  页码
     * @param pageSize 数据数
     * @return
     */
    PageInfoVO<UserListVO> listUserWithPagination(Integer pageNum, Integer pageSize);

    /**
     * 根据用户ID获取用户详情信息
     *
     * @param userId 用户ID
     * @return 用户详情
     */
    UserDetailVO getUserDetailByUserId(Long userId);

    /**
     * 更新用户状态
     *
     * @param userUpdateTypeDTO 更新用户状态数据转换对象
     */
    void updateUserType(UserUpdateTypeDTO userUpdateTypeDTO);

    /**
     * 通过搜索条件查询分页的用户列表
     *
     * @param userSearchDTO 用户搜索条件
     * @return 分页的用户列表信息
     */
    PageInfoVO<UserListVO> listUserBySearchCondition(UserSearchDTO userSearchDTO);

    /**
     * 根据用户ID删除用户信息
     * @param userIdList 用户ID列表
     */
    void deleteUserByIds(List<Long> userIdList);

}
